8bitfiles.net/archives

home *** CD-ROM | disk | FTP | other *** search

/ 8bitfiles.net/archives / archives.tar / archives / compuserve-file-archive / 12 C64 Telecom / KER22B.SDA / KERMIT 5.DOC < prev next >

Wrap

Text File | 2019-04-13 | 12.5 KB | 463 lines

├-64/128 ╦ERMIT ╒SER'S ╟UIDE ╨AGE 23 ╦ERMIT-65>QUIT ╥ECEIVE ╘HE ╥┼├┼╔╓┼ COMMAND CAUSES ├-64/128 ╦ERMIT TO WAIT FOR THE REMOTE ╦ERMIT TO INITIATE A FILE TRANSFER (USING A COMMAND LIKE ╙┼╬─). ╘HE FORMAT FOR THIS COMMAND IS: ╦ERMIT-65>RECEIVE [FILENAME] WHERE [FILENAME] IS ANY VALID ├┬═ ─╧╙ FILE NAME NOT CONTAIN- ING SPACES. ╔F NO FILE NAME IS GIVEN, ├-64/128 ╦ERMIT WILL WAIT FOR A FILE TRANSFER INITIALIZATION SEQUENCE FROM THE OTHER ╦ERMIT. ╔F A FILE NAME IS GIVEN, THAT FILE NAME WILL BE USED TO STORE THE RECEIVED FILE(S), REGARDLESS OF WHAT NAME IS SUPPLIED BY THE OTHER ╦ERMIT. ╔F MORE THAN ONE FILE IS RECEIVED, THE SECOND FILE WILL HAVE A ".00" APPENDED TO IT. ╘HE THIRD FILE WILL HAVE A ".01", AND SO ON. ╘HE FILE NAME WILL BE TRUNCATED APPROPRIATELY TO ACCOMMODATE THE ".╪╪" SUFFIX. ╔F ╞╔╠┼-╫┴╥╬╔╬╟ IS TURNED ╧╞╞, THE ".╪╪" SUF- FIX SCHEME WILL NOT BE USED-- TRANSMISSION WILL STOP WITH DISK ERROR 63, ╞╔╠┼ ┼╪╔╙╘╙. ╙OME EXAMPLES: ╦ERMIT-65>RECEIVE ╦ERMIT-65>RECEIVE MYFILE ╥ESTORE ╘HE ╥┼╙╘╧╥┼ COMMAND IS USED TO RE-INITIALIZE ╦ERMIT PARAME- TERS THAT HAVE BEEN PREVIOUSLY SAVED WITH THE ╙┴╓┼ COMMAND. ╦ERMIT SEARCHES THE DISK IN DEVICE 8 FOR A FILE NAMED ╦┼╥═╔╘.╔╬╔. ╔F THIS FILE IS PRESENT ON DISK, ╦ERMIT LOADS THE PARAMETERS CONTAINED THEREIN AND RESTARTS ITSELF WITH THOSE NEW PARAMETERS. ╔F NO ╦┼╥═╔╘.╔╬╔ FILE IS FOUND, ╦ER- MIT CRASHES, EXITING TO ┬┴╙╔├. ┘OU MUST INSERT A DISK CON- TAINING A ╦┼╥═╔╘.╔╬╔ FILE IN ORDER TO RESTART ╦ERMIT. ╥┼╙╘╧╥┼ HAS NO ARGUMENTS, WITH THE COMMAND FORMAT: ╦ERMIT-65>RESTORE ╙AVE ╘HE ╙┴╓┼ COMMAND SAVES TO THE DISK IN DEVICE 8 THE CURRENT ╦ERMIT SETTINGS AND PARAMETERS IN THE FILE ╦┼╥═╔╘.╔╬╔. ╔F A ╦┼╥═╔╘.╔╬╔ ALREADY EXISTS ON THE DISK, NO ATTEMPT IS MADE TO WRITE OVER THE EXISTING FILE. ╘HE BLINKING RED LIGHT ON THE DISK DRIVE INDICATES ERROR #63, ╞╔╠┼ ┼╪╔╙╘╙. ╔T CAN BE SCRATCHED USING THE ─╔╙╦ COMMAND, HOWEVER. ╘HE PARAMETERS MAY LATER BE RECALLED WITH THE ╥┼╙╘╧╥┼ COMMAND. ╙┴╓┼ HAS NO ARGUMENTS, WITH THE FORMAT: ╨AGE 24 ├-64/128 ╦ERMIT ╒SER'S ╟UIDE ╦ERMIT-65>SAVE ╙END ╘HE ╙┼╬─ COMMAND ALLOWS YOU TO SEND A FILE TO THE REMOTE ╦ERMIT. ╘HE COMMAND FORMAT IS: ╦ERMIT-65>SEND [FILENAME] WHERE [FILENAME] IS ANY VALID ├┬═ ─╧╙ FILENAME. ╨LEASE NOTE THAT THE ├-64/128 CURRENTLY DOES NOT HAVE A WILDCARD SEND CAPABILITY. ╔N OTHER WORDS, THE ENTIRE FILE NAME MUST BE SPECIFIED-- NO PATTERN MATCHING IS ALLOWED. ┴LSO, ONLY ONE FILE MAY BE SENT PER ╙┼╬─ COMMAND. ╙ET ╘HE ╙┼╘ COMMAND IS USED TO ALTER VARIOUS ╦ERMIT PARAMETERS. ╘HE FORMAT OF THIS COMMAND IS: ╦ERMIT-65>SET [OPTION] [SUBOPTION]... WHERE [OPTION] IS ONE OF THE FOLLOWING: ┬AUD ┬OLD ┬ORDER ├HARACTER ─ARK-BACKGROUND ─EBUGGING ┼IGHT-BIT-QUOTING ┼SCAPE ╞ILE-BYTE-SIZE ╞ILE-TYPE ╞ILE-WARNING ╞LOW-CONTROL ╔┬═ ╠IGHT-BACKGROUND ╠OCAL-ECHO ╨ARITY ╥ECEIVE ╥╙232-REGISTERS ╙CREEN-DRIVER ╙END ╘ERMINAL-EMULATION ╫ORD-SIZE ═ANY OF THE ABOVE OPTIONS HAVE SUB-OPTIONS. ┴ DESCRIPTION OF THE OPTIONS AND SUB-OPTIONS FOLLOWS. ╙ET ┬AUD ╘HE ╙┼╘ ┬┴╒─ COMMAND IS USED TO SET THE SPEED AT WHICH COM- MUNICATIONS WILL TAKE PLACE. ╘HE FORMAT IS: ╦ERMIT-65>SET BAUD [VALUE] WHERE [VALUE] IS ONE OF THE FOLLOWING: 300 1200 2400 ╨LEASE NOTE THAT COMMUNICATION SPEEDS ABOVE 1200 ARE POSSI- BLE ╧╬╠┘ ON A ├-128 WHEN USING THE ├╧══╧─╧╥┼-128 SCREEN DRIVER. ┬ECAUSE OF HARDWARE LIMITATIONS, SPEEDS ABOVE 1200 BAUD ARE NOT POSSIBLE ON A ├-64. ┴LSO, PLEASE NOTE THAT THIS COMMAND DOES NOT SUPPORT SPEEDS UNDER 300 BPS. ┘OU ├-64/128 ╦ERMIT ╒SER'S ╟UIDE ╨AGE 25 WILL NEED TO USE THE ╙┼╘ ╥╙232-╥┼╟╔╙╘┼╥╙ COMMAND INSTEAD. ╙EE THE ╙┼╘ ╥╙232-╥┼╟╔╙╘┼╥╙ SECTION AND THE ╦NOWN ╥ESTRIC- TIONS SECTION OF ┴PPENDIX ┴ FOR FURTHER INFORMATION. ╙ET ┬OLD ╘HE ╙┼╘ ┬╧╠─ COMMAND SETS THE BOLD CHARACTER COLOR, WHICH CAN BE USED FOR HIGHLIGHTING TEXT IN ╓╘-100 EMULATION MODE. ┴N EXAMPLE OF BOLD TEXT IS THE "╘YPE ? FOR HELP" MESSAGE WHEN ╦ERMIT BOOTS. ╘HE DEFAULT BOLD COLOR IS WHITE. ╘HE FORMAT OF THIS COMMAND IS: ╦ERMIT-65>SET BOLD [COLOR] WHERE [COLOR] IS ONE OF THE FOLLOWING: ┬LACK ┬LUE ┬ROWN ├YAN ─ARK-GREY ╟REEN ╠IGHT-BLUE ╠IGHT-GREEN ╠IGHT-GREY ╠IGHT-RED ═EDIUM-GREY ╧RANGE ╨URPLE ╥ED ╫HITE ┘ELLOW ╟ENERAL ╬OTES ON ├OLOR ╘HE ABOVE COLORS CORRESPOND TO THE ├-64 ╓╔├ CHIP COLORS. ┴ CLOSEST MAPPING WAS DONE FOR THE ├-128 8563 ╓─├ (THE 80- COLUMN CHIP) ┬╒╘: 1) ORANGE IS REALLY A DARK PURPLE WHILE 2) MEDIUM-GREY HAS A GREENISH TINT. ┴LSO, NOTE THAT: 1) ╘HE ├-128 DISPLAY HAS NO BORDER (JUST LIKE A REAL ╓╘- 100). 2) ╘HE ┬╔-80 HAS NO COLOR OPTIONS OR BORDER-- AND, ANY HIGHLIGHTED TEXT IS PRINTED AS REVERSE. 3) ╬ONE OF THE ╙┼╘ COMMANDS FOR COLOR CURRENTLY HAVE A CORRESPONDING ╙╚╧╫ COMMAND. ┴ REAL ╓╘-100 TERMINAL DOESN'T HAVE ANY COLOR OPTIONS AT ALL-- SIMPLY LIGHT TEXT ON A DARK BACKGROUND, OR VICE VERSA. ╙O, MOST OF ╦ERMIT'S SCREEN DRIVERS GIVE YOU AN ADDED CAPA- BILITY WITH THEIR COLOR OPTIONS. ╙ET ┬ORDER ╘HE ╙┼╘ ┬╧╥─┼╥ COMMAND SETS THE BORDER COLOR, WHICH IS AVAILABLE ONLY WHEN USING THE ├-64 40 OR 80 COLUMN SCREEN DRIVERS. ╘HE DEFAULT BORDER COLOR IS BLUE. ╘HE FORMAT OF THIS COMMAND IS: ╦ERMIT-65>SET BORDER [COLOR] WHERE [COLOR] IS ONE OF THE COLORS LISTED UNDER THE "╙ET ╨AGE 26 ├-64/128 ╦ERMIT ╒SER'S ╟UIDE ┬OLD" SECTION. ╙ET ├HARACTER ╘HE ╙┼╘ ├╚┴╥┴├╘┼╥ COMMAND SETS THE NORMAL CHARACTER COLOR. ╘HE DEFAULT CHARACTER COLOR IS BLACK. ╘HE FORMAT FOR THIS COMMAND IS: ╦ERMIT-65>SET CHARACTER [COLOR] WHERE [COLOR] IS ONE OF THE COLORS LISTED UNDER THE "╙ET ┬OLD" SECTION. ╙ET ─ARK-BACKGROUND ╘HE ╙┼╘ ─┴╥╦-┬┴├╦╟╥╧╒╬─ COMMAND SETS THE ╓╘-100 DARK BACK- GROUND COLOR (THE ONE NORMALLY USED). ╘HIS IS ALSO THE BACKGROUND COLOR USED IN ╓╘-52 MODE OR WHEN NO TERMINAL EMU- LATION IS USED. ╘HE DEFAULT DARK-BACKGROUND COLOR IS MEDIUM-GREY. ╘HE FORMAT FOR THIS COMMAND IS: ╦ERMIT-65>SET DARK-BACKGROUND [COLOR] WHERE [COLOR] IS ONE OF THE COLORS LISTED UNDER THE "╙ET ┬OLD" SECTION. ╙ET ─EBUGGING ╘HE ╙┼╘ ─┼┬╒╟╟╔╬╟ COMMAND IS USED TO SET THE TYPE OF DEBUG- GING GENERATED BY ├-64/128 ╦ERMIT DURING A FILE TRANSFER. ╘HE FORMAT IS: ╦ERMIT-65>SET DEBUGGING [KEYWORD] WHERE [KEYWORD] IS EITHER ╧╞╞, ╘┼╥╙┼, OR ╓┼╥┬T╙┼. ╧╞╞ CAUSES ALL DEBUGGING OUTPUT TO BE SUPPRESSED. D╘┼╥╙┼ D RECTS A COPY OF EACH PACKET TO THE SCREEN, PRINTING ANY CONTROL CHARACTERS AS <├╘╥╠> - <"CHAR">. ╓┼╥┬╧╙┼ PRINTS IDENTIFYING TEXT FOR EACH FIELD IN THE HEADER AND PRINTS THE ACTUAL DATA SECTION OF THE PACKET IN THE SAME MANNER ╘┼╥╙┼ USES. ╙ET ┼IGHT-BIT-QUOTING ╘HIS COMMAND TURNS ON OR TURNS OFF THE EIGHT-BIT-QUOTING FEATURE. ┼IGHT BIT QUOTING IS USED TO TRANSMIT EIGHT-BIT BYTES OVER A SEVEN-BIT DATA PATH. ╔F THE ╫╧╥─-╙╔┌┼ IS ╙┼╓┼╬-┬╔╘, EIGHT BIT QUOTING ALLOWS FULL EIGHT-BIT DATA TO STILL BE TRANSMITTED. ╔F THE ╫╧╥─-╙╔┌┼ IS ┼╔╟╚╘-┬╔╘, THE QUOTING IS IGNORED AS IT IS NOT NEEDED. ╘HE FORMAT OF THE COMMAND IS: ╦ERMIT-65>SET EIGHT-BIT-QUOTING [KEYWORD] ├-64/128 ╦ERMIT ╒SER'S ╟UIDE ╨AGE 27 WHERE [KEYWORD] IS ╧╬ OR ╧╞╞. ╙ET ┼SCAPE ╘HIS COMMAND SETS THE ESCAPE CHARACTER, WHICH IS THE CHARAC- TER USED TO "ESCAPE" BACK TO ├OMMAND ═ODE FROM ├ONNECT ═ODE. ╘HE LOMMAND TAKES A HEXADECIMAL VALUE OF THE CHOSEN CHARAC- TER TO USE AS THE ESCAPE CHARACTER. ╘HE DEFAULT CHARACTER IS <├╘╥╠> - <┘> ($19). ╔T IS USUALLY A GOOD IDEA TO SET THIS CHARACTER TO SOMETHING WHICH IS NOT USED (OR AT LEAST NOT USED VERY OFTEN) ON THE SYSTEM TO WHICH ├-64/128 ╦ERMIT IS CONNECTED. ╘HE FORMAT OF THE COMMAND IS: ╦ERMIT-65>SET ESCAPE [HEX VALUE] WHERE [HEX VALUE] IS THE ┴╙├╔╔ VALUE, IN HEX, OF THE CHARAC- TER TO USE AS THE ESCAPE CHARACTER. ╙ET ╞ILE-BYTE-SIZE ╘HIS COMMAND SETS THE BYTE SIZE ├-64/128 ╦ERMIT WILL USE FOR FILES BEING RECEIVED OR TRANSMITTED. ╘HE FILE BYTE SIZE CAN ALMOST ALWAYS BE ┼╔╟╚╘-┬╔╘, AS THIS SETTING WILL WORK FOR MOST ╙┼╓┼╬-┬╔╘ AND ┼╔╟╚╘-┬╔╘ DATA FILES. ╘HE FORMAT OF THIS COMMAND IS: ╦ERMIT-65>SET FILE-BYTE-SIZE [SIZE] WHERE [SIZE] IS ╙┼╓┼╬-┬╔╘ OR ┼╔╟╚╘-┬╔╘. ╙ET ╞ILE-TYPE ╘HIS COMMAND TELLS ╦ERMIT WHAT TYPE OF FILE IS BEING SENT OR RECEIVED. ╔T IS IMPORTANT THAT THIS PARAMETER BE SET CORRECTLY SINCE IT IS USED TO DETERMINE THE EXACT FILE LENGTH WHEN SENDING FILES IN ADDITION TO DETERMINING SPECIAL PROCESSING WHICH MAY HAVE TO BE DONE (I.E. WHEN RECEIVING A TEXT FILE, WRITE ALL CHARACTERS IN ╨┼╘╙├╔╔). ╘HE FORMAT OF THIS COMMAND IS: ╦ERMIT-65>SET FILE-TYPE [TYPE] WHERE [TYPE] IS ┴╙├╔╔, ┬╔╬┴╥┘, ├-╨╧╫┼╥, ╨┼╘╙├╔╔, OR ╙├╥╔╨╘. ┴N ┴╙├╔╔ TYPE FILE IS ANY STANDARD ┴╙├╔╔ TEXT FILE. ┴ ┬╔╬┴╥┘ TYPE FILE IS A MEMORY IMAGE (I.E. MACHINE LANGUAGE PROGRAM, GRAPHICS SCREEN, ETC.) AND IS NORMALLY TRANSFERRED IN EIGHT-BIT MODE. ┴ ├-╨╧╫┼╥ TYPE FILE IS A ├ LANGUAGE SOURCE FILE FOR USE WITH THE ├ ╨OWER ├ COMPILER FROM ╨RO- ╠INE (NOW SOLD AS ╨OWER ├ BY ╙PINNAKER). ┴ ╨┼╘╙├╔╔ TYPE FILE IS A ├┬═ ┴╙├╔╔ TEXT FILE. ┴ ╙├╥╔╨╘ TYPE FILE IS A FILE PRODUCED BY THE ╙PEEDSCRIPT WORD PROCESSOR PUBLISHED BY ├OM- ╨AGE 28 ├-64/128 ╦ERMIT ╒SER'S ╟UIDE PUTE! ╨UBLICATIONS. ╙ET ╞ILE-WARNING ╘HIS COMMAND DETERMINES WHAT ├-64/128 ╦ERMIT WILL DO WHEN IT RECEIVES A FILE WITH A FILENAME THAT ALREADY EXISTS. ╔F ╞╔╠┼-╫┴╥╬╔╬╟ IS TURNED ╧╬, ├-64/128 ╦ERMIT WILL NOT OVERWRITE THE OLD FILE. ╔NSTEAD, IT WILL CREATE A FILE WITH THE ORIGINAL FILE NAME WITH A ".00" APPENDED TO IT. ╔T WILL INCREMENT THE ".╪╪" NUMBER UNTIL IT SUCCEEDS IN CREATING A UNIQUE FILE NAME. ╔F ╞╔╠┼-╫┴╥╬╔╬╟ IS TURNED ╧╞╞, ├-64/128 ╦ERMIT WILL STOP WITH DISK ERROR 63, ╞╔╠┼ ┼╪╔╙╘╙. ╘HE FOR- MAT OF THIS COMMAND IS: ╦ERMIT-65>SET FILE-WARNING [KEYWORD] WHERE [KEYWORD] IS EITHER ╧╬ OR ╧╞╞. ╙ET ╞LOW-CONTROL ╘HE ╙┼╘ ╞╠╧╫-├╧╬╘╥╧╠ COMMAND ENABLES OR DISABLES ╪╧╬/╪╧╞╞ FLOW CONTROL. ╫ITH FLOW CONTROL ON, ├-64/128 ╦ERMIT WILL AUTOMATICALLY SEND A <├╘╥╠> - <╙> TO THE HOST COMPUTER WHEN IT CAN'T KEEP UP (I.E. BUFFER FULL) TO PREVENT LOSS OF CHAR- ACTERS. ╦ERMIT WILL THEN SEND A <├╘╥╠> - <╤> WHEN IT IS READY TO RECEIVE MORE DATA. ╘HIS OPTION IS RECOMMENDED FOR COMMUNICATION SPEEDS OF 1200 BAUD OR HIGHER. ╘HE FORMAT OF THIS COMMAND IS: ╦ERMIT-65>SET FLOW-CONTROL [KEYWORD] WHERE [KEYWORD] IS EITHER ╧╬ OR ╧╞╞. ╙ET ╔┬═ ╘HE ╙┼╘ ╔┬═ COMMAND SETS UP ├-64/128 ╦ERMIT TO COMMUNICATE WITH CERfAIN ╔┬═ MAINFRAMES. ╘HIS COMMAND IS NEEDED ON A LIMITEf NUMBERûOF SYSTEMS. ╘HE FORMAT OF THIS COMMAND IS: ╦ERMIT-65>SET IBM [KEYWORD] WHERE [KEYWORD] IS EITHER ╧╬ OR ╧╞╞. ╫ITH ╔┬═ MODE ON, ├- 64/128 ╦ERMIT WAITS FOR THE ╔┬═ TURNAROUND CHARACTER (╪╧╬, <├╘╥╠> - <╤>) BEFORE SENDING ANY CHARACTERS TO THE OTHER ╦ERMIT. ╔T ALSO FORCES THE PARITY TYPE TO BE MARK, THE WORD LENGTH TO BE SEVEN-BIT, TURNS ON LOCAL ECHO FOR THE ├╧╬╬┼├╘ COMMAND AND TURNS OFF FLOW-CONTROL. ┴LL OF THESE CHANGES ARE TEMPORARY. ╫HEN ╔┬═ MODE IS TURNED OFF, ANY PARAMETERS ├-64/128 ╦ERMIT ╒SER'S ╟UIDE ╨AGE 29 ALTERED ARE RETURNED TO THEIR PREVIOUS VALUES. ╙ET ╠IGHT-BACKGROUND ╘HE ╙┼╘ ╠╔╟╚╘-┬┴├╦╟╥╧╒╬─ COMMAND SETS THE ╓╘-100 LIGHT BACK- GROUND COLOR (THE ONE NOT NORMALLY USED). ╘HE LIGHT BACK- GROUND IS GENERALLY USED ONLY BY PROGRAMS TO CATCH YOUR ATTENTION (USUALLY BY FLASHING THE BACKGROUND COLOR QUICKLY). ╘HE DEFAULT LIGHT-BACKGROUND COLOR IS fIGHT-GREY. ╘HE FORMAT FOR THIS COMMAND IS: ╦ERMIT-65>SET LIGHT-BACKGROUND [COLOR] WHERE [COLOR] IS ONE OF THE COLORS LISTED UNDER THE "╙ET ┬OLD" SECTION. ╙ET ╠OCAL-ECHO ╘HE ╙┼╘ ╠╧├┴╠-┼├╚╧ COMMAND SPECIFIES WHETHER CHARACTERS SHOULD BE ECHOED LOCALLY WHEN CONNECTED TO ANOTHER COMPUTER. ╔F ╠╧├┴╠-┼├╚╧ IS SET ╧╬, ANY CHARACTER TYPED ON THE ├J64/128 WILL BE ECHOED IMMEDIATELY TO THE ├-64/128 AS WELL AS BEING SENT TO THE OTHER COMPUTER. ╘HIS SETUP IS USEFUL WHEN YOU ARE CONNECTED TO ANOTHER PERSONAL COMPUTER. ╔F ╠╧├┴╠-┼├╚╧ IS SET ╧╞╞, THE CHARACTERS TYPED ON THE ├-64/128 ARE SENT ONLY TO THE OTHER COMPUTER (WHICH WOULD NORMALLY ECHO THE CHARACTERS). ╘HIS ARRANGEMENT IS USED BY MOST MAINFRAME HOSTS. ╘HE FORMAT OF THIS COMMAND IS: ╦ERMIT-65>SET LOCAL-ECHO [KEYWORD] WHERE [KEYWORD] IS EITHER ╧╬ OR ╧╞╞. ╙ET ╨ARITY ╘HIS COMMAND DETERMINES THE TYPE OF PARITY TO USE DURING COMMUNICATION. ╦ERMIT NORMALLY USES CHARACTERS WHICH CON- SIST OF EIGHT DATA BITS WITH NO PARITY BIT. ╞OR SYSTEMS OR TRANSMISSION MEDIA WHICH REQUIRE A SPECIFIC PARITY TYPE, ╦ERMIT CAN SEND CHARACTERS AS SEVEN DATA BITS PLUS A PARITY BIT. ╘HE FORMAT OF THIS COMMAND IS: ╦ERMIT-65>SET PARITY [KEYWORD] WHERE [KEYWORD] IS ONE OF THE FOLLOWING: